---
title: Consolidated-case propagation
summary: Mirrors the primary case's status, LCE excusal/transfer state, file location, and DEF-sent flag onto its secondary consolidated cases.
status: draft
owner: SAIF Documentation Pipeline
last_reviewed: 2026-08-21
library: SAIF.Application.Claim.Legal
reference_type: embedded
operation_id: OP-LGL-010
trigger: Save of the primary case
---

# Consolidated-case propagation

This operation propagates state changes on a primary legal case onto every secondary (non-primary) case in its consolidation group, so that consolidated cases stay consistent with the primary case.

| Field | Value |
| --- | --- |
| **Operation ID** | OP-LGL-010 |
| **Trigger** | Save of the primary case |
| **Inputs** | `CurrentCase.Consolidations` |
| **Outputs** | Updated, saved secondary `clsLegalCase` records |
| **Primary components** | `LegalManagerBase.updateConsolFileLocation`, `updateConsolLCE`, `UpdateConsolCaseStatus`, `UpdateConsolDEFFLag` |
| **Entry point** | `SAIF.Application.Claim.Legal\LegalManagerBase.vb` |

## Steps

1. Iterate `CurrentCase.Consolidations` for non-primary, secondary cases.
2. For each secondary case:
   - Load the related `clsLegalCase` via `clsLegalCase.GetLegalCase`.

     > **Origin**: delegates to `SAIF.Business.Claim.Legal` (see [operations and processes](../../saif-business-claim-legal/operations-processes.md)) — inferred/best-effort pointer; step sequence not traced in this run's Stage 1 analysis.*
   - Propagate the relevant state from the primary case, depending on which propagation method is invoked:
     - `updateConsolFileLocation` — file location
     - `updateConsolLCE` — LCE due-date/excusal state
     - `UpdateConsolCaseStatus` — case status
     - `UpdateConsolDEFFLag` — DEF-sent flag
   - Save the secondary case ([BR-LGL-012](../business-rules.md#br-lgl-012-secondary-consolidated-cases-mirror-the-primary-case-state)).

     > **Origin**: delegates to `SAIF.Business.Claim.Legal` (`clsLegalCase.Save`) — inferred/best-effort pointer; step sequence not traced in this run's Stage 1 analysis.*

## Process flow

The following diagram visualizes this operation's control flow.

```mermaid
flowchart TD
	Start([Primary case saved]) --> Iterate[Iterate secondary<br>consolidated cases]
	Iterate --> Load[Load secondary clsLegalCase]
	Load --> Propagate[Propagate file location/LCE/<br>status/DEF flag from primary]
	Propagate --> Save[Save secondary case]
	Save --> More{More secondary cases?}
	More -->|Yes| Iterate
	More -->|No| EndOk([Done])
```

## Failure and edge-case behavior

- A case with no secondary consolidated cases: this operation performs no updates.
- Called from multiple entry points (DEF printing, DEF email, case-status/LCE/file-location changes) via the four dedicated `updateConsol*` methods, each targeting one specific piece of propagated state.

> **Note:** Statements marked with `*` were inferred from code structure, naming
> conventions, or contextual evidence where direct confirmation was not available
> in source artifacts.

## Related documentation
- [Operations and processes](../operations-processes.md)
- [Business rules](../business-rules.md)
- [SQL catalog](../sql/index.md)
- [Database tables](../database-tables.md)

## Sources
- `SAIF.Application.Claim.Legal\LegalManagerBase.vb`
